publishMetadata

Returns a list of songs that have changed (according to the song edit date) since a specified time or since the last time this command was called.

Sample Request

<mmRequest command="publishMetadata" station="ID" [version="1"] [client=""] [userData=""] [timeFormat=""]>
	<contents>
		[<properties>
				<property name="lastedit">2015-01-01T00:00:00</property>
		</properties>]
		[<fields>
			<field id="12" />
			<field name="Artist" />
			<field name="Title" />
		</fields>]
	</contents>
</mmRequest>

Request Notes

This command basically performs the same operation as if you used to search for songs where the last edit date (field 27) is later than a specific time. If you wanted to return the entire library, you could set the time stamp to a long ago year, like 1899. This command does record the last time it was called and will automatically return the list of songs changed since that time if no date/time is specified.

 

station="ID" - While this is typically used against a station, you can set station="Enterprise" when you make this call. When used for Enterprise, it only returns changes made to songs at the Enterprise level.

 

"last edit" - This is based upon the date and time and is designed to return songs that have changed since a specific time. The time of the latest change it returns is saved so the next time you can call this without the lastedit property and it will automatically give you anything changed since the last time. If this returns some changes, it will note the date/time of the most recently edited element and return any songs changed after that date/time the next time the call is made.

 

While MusicMaster has a way of automatically tracking timestamps, it does so only overall, so if more than one system will access the Nexus Server, we recommend the third party system include and manage this time stamp.

 

If you wish to include additional song fields, specify those in the options “field" section.

 

Deleted songs - There is an option in Enterprise Configuration under Nexus called "Include deleted songs when publishing". This only includes songs that are completely deleted from the library and removed from station. There is also an option in Stations under Nexus with the same name. This only includes songs that are completely deleted from the station and also deleted from that station in Enterprise. In a Station, a song is considered deleted if it is removed from the station without being deleted from Enterprise and also if the song is deleted from Enterprise. It shows songs deleted from Enterprise since a song deleted there would also no longer be in the station. If you only want to see songs removed from a station, you would use the station option. You can use both options at the same time. This will include all deleted songs, even those that were not assigned to the station you specify. For both options, Nexus returns the notification of 'deleted="1"'..

Sample Reply

<mmCommand command="publishMetadata" station="ID" version="1" status="ok">
    <contents>
        <songList recordCount="2">
            <song songId="1" />
            <song songId="2" deleted="1" />
        </songList>
    </contents>
</mmReply>

Reply Notes

By default, this command will only return the song ID of the songs that have changed. You can include the options Fields section in your request if you wish to return additional data.

Compatibility and Version Info

Available in MusicMaster PRO 5.0sr15 and later

 

This command may have a vendor specific override available and when that is the case, this command may be automated to push changes to your automation system by adding a command to the Interface section of MMServer.ini when using MusicMaster PRO:

 

PublishMetaData=[interval]

Where [interval] is specified as the number of seconds (S,n), minutes (M,n) or hours (H,n) between calls to this command. Example: PublishMetaData=S,15 (will call this command every 15 seconds)